home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_479 / uucp / uucp113.2.lzh / uucp2 / man / News < prev    next >
Text File  |  1990-12-27  |  7KB  |  169 lines
  1.  
  2.                    NEWS
  3.  
  4.     The NEWS system consists of many programs:
  5.  
  6.     (1) rnews
  7.  
  8.     RNews is run by UUXQT which is run by UUCICO after a transfer.
  9.     RNews takes incomming news (which is normally batched) and breaks
  10.     it up into articles, placing each article in the appropriate
  11.     newsgroup in UUNEWS:  The sequence number of the article is tracked
  12.     with a file called .next that exists in each news directory.
  13.  
  14.     RNews is also called by PostNews to post articles you send out
  15.     locally as well as queue them, via the UULIB:Sys file, to other
  16.     systems (see BATCHNEWS)
  17.  
  18.     (2) trimnews
  19.  
  20.     TrimNews is normally run nightly by a DCron entry and deletes all
  21.     news files over N days old.  The number of days is programmable for
  22.     each newsgroup from the UULIB:NewsGroups file.    Each line in this
  23.     file is of the form:
  24.  
  25.         <newsgroup> <#days-till-expiration>
  26.  
  27.     example:
  28.  
  29.         comp.sys.amiga.tech 15
  30.  
  31.     Where the second field is optional.  If the second field does not exist
  32.     it is assumed to be 7 (7 days).  If the second field is 0 then that
  33.     particular group will not be trimmed.
  34.  
  35.     If you are receiving news this is pretty much a neccessity to prevent
  36.     news files from building up and filling the disk.
  37.  
  38.     NOT RUNNING TRIMNEWS MEANS THAT ARTICLES WILL CONTINUE TO PILE UP
  39.     UNTIL THE DISK IS FULL!
  40.  
  41.     (3) DNews
  42.  
  43.     DNews is the new news reader, ANews is the old.  ANews is being phased
  44.     out.
  45.  
  46.     DNews may be used to read and reply to news.  DNews keeps track of
  47.     the articles you have read in a file called UULIB:<user>.DNewsRC,
  48.     where <user> is the UserName config entry.  The USERNAME enviroment
  49.     variable overides the config entry allowing multiple news readers
  50.     to have their own DNewsRc file.
  51.  
  52.     DNews does not delete or modify any news file, allowing news routing
  53.     in a future UUCP release as well as multi-user support.
  54.  
  55.     (4) BatchNews
  56.  
  57.     BatchNews takes articles queued to other systems via the UULIB:Sys
  58.     file and batches them together into actual spool files.  Each system
  59.     in UULIB:Sys has a file called UUSPOOL:BATCH/<system_name> which
  60.     lists articles bound for that system.  This file is appended to by
  61.     RNews when it receives news.
  62.  
  63.     (5) CBatch
  64.  
  65.     CBatch is called by BatchNews to compress an article
  66.  
  67.  
  68.                 RECEIVING NEWS
  69.  
  70.     To receive news you must contact a site that receives news and ask them
  71.     to send you news.  Sites normally handle this in one of two ways:
  72.  
  73.     (1) Lazy sites will want to send you ALL the newsgroups (about 2MBytes
  74.         a day) or not send you news at all.
  75.  
  76.     (2) Properly managed sites will be able to batch up specific groups
  77.         for you.  This is preferable, since you will most likely only
  78.         want to read a couple of groups.
  79.  
  80.     The setup on your end consists of editing the UULIB:NewsGroups file to
  81.     list all the groups you want to extract out of the stream.    Henceforth,
  82.     any news sent to you by the other system will automatically be
  83.     unbatched and available to DNews.  Here is an example of this file:
  84.  
  85.     -------------- cut here -----------
  86.     comp.sys.amiga    7
  87.     comp.sys.amiga.tech 7
  88.     news.admin        7
  89.     rec.games.frp    7
  90.     news.misc        7
  91.     junk        1
  92.     -------------- cut here -----------
  93.  
  94.     Each line consists of two fields.  The first is the name of the
  95.     newsgroup.    The second field specifies the number of days a
  96.     particular message should be kept on your system before it expires.
  97.  
  98.     The TRIMNEWS program scans all newsfiles looking for files older
  99.     than the specified number of days and deletes them.  TRIMNEWS should
  100.     be run from your cron once per day.  If you do not run TRIMNEWS,
  101.     news files will build up over the weeks until you run out of disk
  102.     space.
  103.  
  104.     Note that there is a 'junk' group specification in UULIB:NewsGroups.
  105.     This is a dummy group to which all messages to unlisted groups are
  106.     placed.  Generally you will want to expire this group on a per day
  107.     basis rather than a weekly (or whatever you choose) basis.  However,
  108.     if you are forwarding news to other sites you will want the timeout
  109.     to be the same as for other groups.  See FORWARDING NEWS below.
  110.  
  111.                 POSTING NEWS
  112.  
  113.     You can post news from DNews.  In order for the posted news to be
  114.     properly queued to your news feed you must have an entry in UULIB:Sys
  115.     that looks like this (assume 'foo' is your news feed):
  116.  
  117.     foo:*
  118.  
  119.     When you post from DNews the article is posted locally and the UULIB:Sys
  120.     file specifies to RNews which other machines should receive the news.
  121.  
  122.     Finally, before you run UUCico you must run the BATCHNEWS program to
  123.     pull the individual article lists destined for machines and actually
  124.     create batch files for them in UUSPOOL:  Normally, BatchNews is run
  125.     by DCron just before UUCico gets run by DCron.
  126.  
  127.     IF YOU DO NOT PROPOGATE NEWS TO OTHER SITES, and basically would
  128.     otherwise run 'BatchNews' manually every time you post an article,
  129.     you can have AmigaUUCP automatically run BatchNews for you on a
  130.     per-posting basis.    To do this add the following Config entry
  131.     to UULIB:Config:
  132.  
  133.     AutoBatch   autobatch
  134.  
  135.     This will cause BatchNews to be run automatically whenever you post
  136.     news.
  137.  
  138.                 FORWARDING NEWS
  139.  
  140.     Please read the manual page 'Sys' and 'BatchNews'... basically, you can
  141.     pass news to other sites by specifying them in the Sys file.
  142.  
  143.     If your machine has a lot of traffic comming from other sites (say you
  144.     host a local Amiga Users Group USENET sub network) you may want to run
  145.     BatchNews several times a day... maybe even once an hour depending on
  146.     how often you expect to get called or call other sites.  Remember that
  147.     NEWS QUEUED TO OTHER MACHINES DOES NOT ACTUALLY GET SPOOLED FOR TRANSFER
  148.     UNTIL BATCHNEWS IS RUN
  149.  
  150.     The system works by storing references to articles in the directory
  151.     UUSPOOL:BATCH/ ... you must create this directory if you intend to
  152.     forward news.  When BATCHNEWS is run, this directory is scan and the
  153.     referenced news articles are pulled from the appropriate directory in
  154.     UUNEWS:, compressed, and batched together for transmission.  A given
  155.     news article will never be batched to a site that it has already been
  156.     to, by virtual of a comparison made between each prospective news
  157.     site and elements in the news Path: header for a given article.
  158.  
  159.     Note that you can propogate any subset of the groups you receive,
  160.     whether or not they are listed in UULIB:NewsGroups .. this is because
  161.     any groups not listed in UULIB:NewsGroups will be placed in the
  162.     UUNEWS:JUNK directory.  THESE ARTICLES ARE STILL CANDIDATES FOR
  163.     NEWS BATCHING, HOWEVER, ALLOWING YOUR PERSONAL GROUP PREFERENCESE TO
  164.     NOT INTERFERE WITH YOUR PROPOGATION OF GROUPS TO OTHER SITES.
  165.  
  166.     Refer to the MAN/DNews manual page for specific information on DNews
  167.  
  168.  
  169.